Magnum One/Magnum One (Mid-American Digital) (Disc Manufacturing).iso/d3/clarion.arc/TWIN.HLP

Clarion Help | 1991-07-24 | 76KB | 1,652 lines

 Main Menu
     Title
Description
  Field
Field
 Data Window
  Select
Field
  Field
Field
Title
Error messages
  Prompt:Field
  Prompt:Selected Field
 Lookup
  Prompt:Field
Worksheet Area
Field
Selected
Field
 !Text
Field
 Structure Lines
Current Line
Status Line
 #Change this Clarion Environment Color
 +Main Menu
Lookup
Worksheet
Action Menu
Border
 This window lists the screen
 elements that we can repaint.
 Let's repaint the prompt
 words in the Data Window.
 Now we press Ctrl-Enter to lock in our new
 colors and return to Tailor's base window.
COPY  Marked Files
PHONEBK.DAT
Mark block to COPY, then press Enter
Format New Structure
  Type:Screen
Screen  Report
Get File
  Filename:
Jump to Line
  Jump to:
Search and Replace
  Search for
Ignore Case
Yes  No
  Replace String
Yes  No
Replace with
Confirm Replace:No
Yes  No
Within Block
Yes  No
Track Type
Single
  Double
  Block
 Mixed
 Mixed
! " # $ % & ' ( ) * + , - . / 0 1 2 3 4 5 6 7 8 9 : ; < = > ?
  @ A B C D E F G H I J K L M N O P Q R S T U V W X Y Z [ \ ] ^ _
  ` a b c d e f g h i j k l m n o p q r s t u v w x y z { | } ~
Execute
  Command:
  11/25/87
The Clarion Director
8:32AM
  DOS Command:
  Pattern
  Sort By
:Name
As Is
  Sort Order :
  Show Hidden:No
Yes No
C:\PHONES
  DOS Pause  :No
Yes No
(Parent)  9-16-87 10:44a
PHONEBK  DAT
2,767 11-13-87 11:39a
  47 Files :
255,917
PHONEBK  K01
2,048 11-09-87  4:28p
0 Marked:
PHONES
6,626 11-13-87 11:11a
 Capacity  :  21,309,440
PHONES
292 11-24-87  3:18p
  In Use
:  20,809,728
PHONES
998 11-05-87  9:49a
  Available:
499,712
PHONES
1,069 11-13-87 11:11a
PHONES
128,745 11-24-87  1:33p
 ^Copy
^Print
PHONES
767 11-19-87  8:48a
 ^Delete
^Rename
PHONES
2,580 11-13-87 11:11a
 ^Flashback
^Select
PHONES
1,897 11-13-87 11:11a
 ^Go to
     ^Tape
PHONES
1,501 11-24-87  3:18p
 ^List
^Unmark
PHONES
966 11-13-87 11:11a
 ^Mark
^eXecute
PHONES
335 11-13-87 11:13a
 This is the Director tutorial.
 Director is a DOS shell that is used to execute DOS
 commands and to display and process DOS directories.
 This is Director's base window.
 The box to the left shows the space used
 by files in the current directory and the
 total space used on the current drive.
 DOS commands can be entered at the cursor.
 We have elected not to pause after a
 DOS command.  If we want to review the
 results of the last command, however,
 we can press Ctrl-F (flashback).
 Director remembers DOS commands.  If you
 want to bring back the last command you
 entered, press Ctrl-left arrow.  Press
 it again for the command before that,
 and so on.  We only entered one command,
 so that is as far as we can go.
 This completes the Director tutorial.
 Now let's go back to the tutorial menu.
  0 Files :
0  0 Marked:
0Capacity  :  21,309,440 In Use
:  20,821,797 Available:
487,643
  7 Files :
12,069  0 Marked:
0Capacity  :  21,309,440 In Use
:  20,821,797 Available:
487,643
  7 Files :
22,582  0 Marked:
0Capacity  :  21,309,440 In Use
:  20,821,797 Available:
487,643
The CLARION Editor
  Input File :C:\PHONES\PHONES.CLA
  Output File:
  Edit File  :
8PHONES
PROGRAM
 IINCLUDE('\CLARION\STD_KEYS.CLA')
 0INCLUDE('\CLARION\CTL_KEYS.CLA')
 0INCLUDE('\CLARION\ALT_KEYS.CLA')
 0INCLUDE('\CLARION\SHF_KEYS.CLA')
 sREJECT_KEY
EQUATE(CTRL_ESC)
 3ACCEPT_KEY
EQUATE(CTRL_ENTER)
 OMODULE('PHONES1')
 APROC(MENU)
 @PHONES.CLA 1:1
 'LIN OVR ZON IND CAP
 The Enter key inserts a blank line below the current line.
 After inserting the blank line, new source can be entered.
 The Editor keeps a stack of deleted characters, lines,
 and blocks.
 Ctrl-U, the Undelete function, pulls the last deleted
 character, line, or block from the deletion stack and
 inserts it at the cursor.
 Remember Ctrl-U
 the Undelete operation
 it will
 come in very handy.
 This is the Editor's worksheet.  This is where you edit or
 revise your Clarion source files. When creating a new file
 from scratch, the worksheet is blank.  Lines 1 through 24
 are used for editing operations.  The current line is
 always highlighted.
 PgUp scrolls the file up to display the previous group of source lines.
 Once you begin to use the Editor, there are several other
 cursor-movement keys you will want to explore:
 Move to the next tab stop.
 Shift-Tab
 Move to the previous tab stop.
 Ctrl-PgDn
 Move to the last line of the source file.
 Ctrl-PgUp
 Move to the first line of the source file.
 Ctrl-Left
 Move to the last character of the previous word.
 Ctrl-Right
 Move to the first character of the next word.
 The Editor has three entry modes:  Insert mode and
 Overwrite mode, which are toggled with the Ins key, and
 Zone-insert mode, which is toggled by the Ctrl-Z key.
 In Overwrite mode, new characters are typed on top of
 existing characters.
 In Insert mode, as a character is typed it pushes all of
 the characters, from the cursor to the end of the line, to
 the right to make room for new characters.
 Zone-insert mode lets you make insertions or deletions
 without causing a column alignment problem.
 The Del key deletes the character at the cursor and pulls
 the rest of the line one position to the left.
 Ctrl-End deletes the characters from the cursor to the end
 of the current line.
 Other deletion keys you will want to explore are:
 Bksp
 deletes the character to the left of the
cursor, then moves the cursor one position
to the left.
 Ctrl-Home
 deletes all of the characters on the current
line and moves the cursor to column one.
 Here is a very important key to know about:
 Ctrl-Bksp
 restores the current line to the state it
was before changes were made, IF it is
pressed before moving the cursor off the
line or initiating another operation.
 Line 25 is reserved for messages and for the current state
 of the edit file and the various edit modes.
Current file
Overwrite
 Zone
 Auto
Scroll
Mode
Insert
Indent
 Lock
Current
Linear
Line:Column
Block
Mode
 Other important editing keys are:
 Gray +
 shifts a line to the right.
 Shift-Gray +
 duplicates the character directly above
the cursor and moves to the right.
 Shift-Gray -
 duplicates the character directly above
the cursor and moves to the left.
 Ctrl-2
 duplicates the current line.
 Ctrl-\
 reverses the case of the character at the
cursor and moves to the right.
 Ctrl-6
 centers the text on the current line.
 To save your source file to disk, press Shift-Enter.  Any
 original version of your file will be renamed with an
 extension of .BAK.
 To save your source and exit the Editor, press Ctrl-Enter.
 Pressing Esc or Ctrl-Esc returns you to the Editor's base
 window without saving the file.  If you changed the file
 during this edit session, the Editor will offer you the
 opportunity to save your new version.
 If you select Yes, you will exit the Editor without
 writing any changes out to disk.  Selecting No will return
 you to the Editor's worksheet.
 If you press Ctrl-F from outside an existing SCREEN or
 REPORT structure, the Editor displays the Format New
 Structure Window.
 Here, you will select the type of structure you wish to create:
 Screen or Report.  When you exit the Screen or Report Formatter
 your source will be inserted at the cursor.
 We have now seen most of the important features of the
 Editor.  We have only touched lightly on the rich set of
 features to be found in the Screen and Report Formatters.
 Many of the features are outside the scope of this
 tutorial and require an understanding of the language
 statements that make up these structures.
 This concludes the Editor tutorial.
 The cursor acts as the Editor's pointer by indicating where
 a character can be typed, where a line can be inserted,
 where a screen or report can be formatted, the location of
 an error
 in short, where any of the Editor's operations
 will occur.
 The Cursor-right (
 ) key moves the cursor one column to the right.
 The Cursor-left  (
 ) key moves the cursor one column to the left,
stopping at column one.
 The Cursor down (
 ) key moves the cursor down to the next line.
 The Cursor up
 ) key moves the cursor up to the previous line.
 The current line is always highlighted.
 When Scroll Lock is on, pressing Cursor Down pulls source lines up
 to the active line, one line at a time.  Likewise, Cursor Up pulls
 source lines down to the active line.
 The End key moves the cursor to the space after the last character
 on the current line.
 Pressing End a second time moves the cursor to the right-most
 column used in the file.
 The Home key moves the cursor to the first character on the current line.
 Pressing Home a second time moves the cursor to column one.
 PgDn scrolls the file down to display the next group of lines in the file.
PAGE_FOOTER
FOOTER
 ,1 17
COL(35)
STRING('Page')
 7COL(40)
STRING(@N_3),USE(MEM:PAGE) CTL(@FF)
 LDONE# = 0
 GPRINT(RPT_HEADER)
 ?SET(NUM:NAME_KEY)
 ?OPEN(REPORT)
 DDO NEXT_RECORD
 BLOOP UTNIL DONE#
 BPRINT(GRP_HEADER)
 ?DO CHECK_PAGE
 CLOOP UNTIL DONE#
 BSAVE_LINE# = LINE#
 >PRINT(DETAIL)
 CDO CHECK_PAGE
 CDO NEXT_RECORD
 OPRINT(GRP_FOOTER)
 ?DO CHECK_PAGE
 OPRINT(RPT_FOOTER)
 =PHONES03.CLA 42:11
 #LIN OVR ZON IND CAP
 Many of the Editor's operations work on blocks.  Blocks can
 be marked as linear or character.  Ctrl-B is used to toggle
 between LIN and CHR blocking.  Linear blocks consist of one
 or more complete lines.  Character blocks consist of one or
 more characters in a rectangle that spans one or more lines.
 The Ignore Case field allows you to tell the Editor to
 match on upper or lower-case letters.  If you answer No,
 an exact match is required.
 You have the option of replacing the search parameter with
 a different string.  If you want to replace, you also have
 the option of having the Editor ask you for confirmation
 prior to making the change.  You also can optionally make
 the search happen only within a marked block.
 Then, if you wish, you can use Ctrl-N to continue the
 search and replace process and find the Next matching
 string.
 Now let's quickly go over some of the remaining Control
 key operations of the Editor.
 Press Ctrl-J to display the Jump to Line window.  To jump
 to a particular line, type in the line number and press
 Enter.  The Editor will immediately change the current
 line to be the line you requested.
 To Get a copy of another file and insert it into the file
 you are editing, press Ctrl-G.  After the Editor accepts
 the filename you enter, it will ask you to move a pointer
 bar to the location in your file where you want to insert
 a copy of the "get" file.
 A Clarion keyboard macro is a stored series of keystrokes, defined
 by you, that can be recalled by pressing the Alt key and any
 designated alphabetic or numeric key.  Key macros are defined with
 the Key Macros Definition Window, stored in the current edit file
 (for example, CLA.EDT), and are created using an innovative learn
 mode.  Started and ended with Ctrl-K, a learn session teaches the
 Editor a set of keystrokes, as you press them, defining a macro.
 The Editor allows you to draw lines and borders with the
 track (Ctrl-T) command.  You can create elaborate comments
 in your source code with graphic box drawings.
 To execute a DOS command without leaving the Editor, press
 Ctrl-X.  Type any valid DOS command at the Command line
 field and press Enter.
 To perform a block operation, begin by specifying the
 operation.  For example, Ctrl-C to copy a block.  Then use
 the cursor controls to mark the size of the block.
 Then press Enter to indicate that the block is marked.
 Then use the cursor controls to point to the destination
 of the copy.
 Press Ctrl-C again to write the copy.
 Then either move to another destination to write the copy,
 or press Esc to end the copy function.
 Other block-oriented operations are:
 Ctrl-D
 Deletes a block.
 Ctrl-L
 Lists a block to your printer.
 Ctrl-M
 Moves a block to another location.
 Ctrl-P
 Puts a copy of a block into another file.
 If the source file your are editing was recently compiled
 with errors, you can use the Ctrl-E operation to jump from
 error to error.  The error is displayed and F1 provides
 additional help.
 The Editor allows you to open a second window and keep two
 edit files active.  Ctrl-W is used to call up the base
 window so that a second file can be specified.
 Ctrl-S calls the Editor's Search and Replace window.  With
 this feature, you can quickly and easily search for a
 particular string and then replace it with another string.
 To request the Editor to search for a specific string,
 first type in the string you wish to locate.  (Search and
 Replace also supports wildcards.)
Error 146:IMPROPERLY FORMED 'LOOP' STATEMENT
 -Press F1 for more help
 A LOOP statement must have one of the following forms:
LOOP count TIMES
LOOP i=initial TO limit BY step
LOOP UNTIL logical expression
LOOP WHILE logical expression
!    '!!'
PHONES03.CLA 42:11
 #LIN OVR ZON IND CAP
The CLARION Editor
  Input File :
  Output File:
  Edit File  :
PHONES03.CLA 42:11
 #LIN OVR ZON IND CAP
MEMBER('PHONES')
 3SHOW_DIR
PROCEDURE(LOOKUP)
 2LOOKUP
EXTERNAL
SCREEN
SCREEN
WINDOW(21,50),PRE(SCR),HUE(7,0)
 %ROW(1,1)
STRING('<201,205{48},187>')
PHONES02.CLA 1:1
 %LIN OVR ZON IND CAP
 Once the second window is open, you can use Ctrl-W at any
 time to switch to the other window.  You can perform any
 of the edit operations in either window, and you can
 perform block operations, such as Copy or Move, between
 the two windows.  At the point at which you must specify
 a destination, you can simply press Ctrl-W and switch to
 the other window, then move to a destination.
 When you have finished editing one of the two files, move
 the cursor to the window you want to close and press
 either Esc to exit or Ctrl-Enter to save your changes and
 exit. You will then return to single-window editing.
MEMBER('PHONES')
 3MENU_DIR
PROCEDURE
SCREEN
SCREEN
WINDOW(12,25),PRE(SCR),HUE(15,1)
 %ROW(4,3)
PAINT(7,21),HUE(0,7)
 1ROW(1,1)
STRING('
 4ROW(2,1)
REPEAT(10);STRING('
<0{23}>
 %ROW(12,1)  STRING('
 4ROW(2,6)
STRING('Phone Directory')
 .COL(21)  ENTRY,USE(?FIRST_FIELD)
 0COL(21)  MENU,USE(?MENU_FIELD)
 0ROW(5,5)
STRING('Display Directory')
 (ROW(7,6)
STRING('Print Directory')
 *ROW(9,12)
STRING('Quit')
EJECT
 KCODE
 LOPEN(SCREEN)
 #!OPEN THE MAIN MENU SCREEN
 +!KEEP RUNNING TILL USER EXITS
ALERT
 "ALERT(REJECT_KEY)
 "ACCEPT
 '!GET THE POINT FIELD
PHONES01.CLA 11:1
 $LIN OVR ZON IND CAP
 This is a Clarion SCREEN structure.
 In the Clarion language a SCREEN structure defines what the end-user
 sees on his monitor and provides a way to gather information that can
 be manipulated by your application program.
 To generate new source
 from your screen design
 press Ctrl-Enter.
 To exit the Screen
 Formatter without
 writing new source,
 press ESC or CTRL-ESC.
 The Editor's Screen Formatter enables you to design a
 screen from scratch, or make changes to an existing screen,
 without writing source statements.  The Formatter can read
 the format of a SCREEN structure, decode the statements,
 and display your design on a worksheet.
 To call the Screen Formatter, you would first position the
 cursor either where you want the statements for a new
 SCREEN structure to be placed in your program, or anywhere
 within an existing SCREEN structure to format that screen.
 Once the cursor is properly positioned, you then simply
 press Ctrl-F.
 After pressing Ctrl-F from within a source SCREEN structure,
 your screen design is displayed on the Screen Formatter's
 worksheet.  New screens start with a blank worksheet.
 The entire monitor
 can be used to design
 your screen.  As with
 the Editor, the cursor
 acts as the Screen
 Formatter's pointer,
 indicating where a
 character should be
 typed, where to begin
 a field or variable,
 or where to begin a
 block or a track.
 Ctrl-S calls the Source window.  The Source window
 is where you change screen characteristics, create
 or change screen variables and data entry fields,
 or rearrange the order of events.
 The source window shows you the source that will
 be generated based on your design.
SCREEN statement
Statement
Size of the
A MENU
Label
window
structure
Position
attributes
!    2    A
 This screen structure defines a menu.  A menu is a type of data
 entry field in which the end-user chooses from a menu of possible
 choices.  This menu contains three choices, which are called
 menu items.  The reverse bar indicates that if we press Enter, we
 will call the menu item string window for this item.
 This window allows us to
 change the description
 or any of the attributes
 of this menu item.
MODULE('PHONES02')
 @PROC(UPD_PHONE)
 OMODULE('PHONES03')
 @PROC(SCROLL_SCR)
 OEJECT('FILE LAYOUTS')
 .PHONEBK
FILE,NAME('C:\PHONE\PHONEBK'),PRE(PHN),CREATE,RECLAIM
NAME_KEY
KEY(PHN:NAME),DUP,NOCASE,OPT
 %RECORD
     RECORD
 ;NAME
STRING(30)
!Name
ADDRESS
STRING(30)
!Address
CITY_STATE
STRING(30)
!City and State
!Zip code
PHONE
DECIMAL(7,0)
!Telephone number
EJECT('GLOBAL MEMORY VARIABLES')
 0GROUP,PRE(MEM)
 5MESSAGE
STRING(40)
!Global Message Area
SHORT
!Report Page Number
SHORT
!Report Line Number
 BPHONES.CLA 25:1
 &LIN OVR ZON IND CAP
MEMBER('PHONES')
PRNT_DIR
PROCEDURE
TITLE
REPORT LENGTH(59),WIDTH(80),PRE(TTL)
RPT_HEADER
DETAIL
 H. .
 @REPORT
REPORT
LENGTH(59),WIDTH(80),PAGE(PAGE#),LINE(LINE#)
PRE(RPT)
 .PAGE_HEADER
HEADER
 ACOL(1)
STRING('
 2ROW(+1,1)
STRING('
 {78}
 2ROW(+1,1)
STRING('
 {32}Phone Directory {31}
ROW(+1,1)
STRING('
 {78}
 2ROW(+1,1)
STRING('
  Name {27}Address {25}Phone {8}
ROW(+1,1)
STRING('
') CTL(@LF2)
 5GRP_HEADER
DETAIL
 5DETAIL
DETAIL
 ACOL(4)
STRING(30),USE(PHN:NAME)
 -COL(35)
STRING(30),USE(PHN:ADDRESS)
 *COL(66)
STRING(@P
PB),USE(PHN:PHONE)
PHONES03.CLA 11:1
 $LIN OVR ZON IND CAP
 This is a Clarion REPORT structure.
 In the Clarion language a REPORT structure declares
 the layout of a printed report.
 The Editor's Report Formatter enables you to design a
 report from scratch, or make changes to an existing report,
 without writing source statements.  The Formatter can read
 the format of a REPORT structure, decode the statements,
 and display your design on a worksheet.
 To call the Report Formatter, you would first position the
 cursor either where you want the statements for a new
 REPORT structure to be placed in your program, or anywhere
 within an existing REPORT structure to format that report.
 Once the cursor is properly positioned, you then simply
 press Ctrl-F.
 After pressing Ctrl-F from within a source REPORT structure,
 your report design is displayed on the Report Formatter's
 worksheet.  New reports start with a clean worksheet.
 Your REPORT structure will
 contain other structures
 within it that describe:
 the information that should
 be printed at the top of
 each page (the HEADER); the
 data that should be printed
 in the body of each page
 (DETAIL structures); and the
 information that should be
 printed at the bottom of
 each page (the FOOTER).
 For a new REPORT structure,
 the worksheet starts with
 empty header, footer, and
 detail areas.
 Ctrl-S calls the Source window.  The Source window is where you can view
 the header, detail, and footer structures in the current report design,
 as well as any variables and control sequences.  The Source window also
 enables you to define the report's characteristics.
 The Source window can be used to change the characteristics of the
 report, the structures within the report, or report variables within
 the structures.  The selector bar is currently on a report variable,
 and if Enter is pressed, the Variable window will appear.
 The Variable window is used to create or modify data variables and
 control sequences for your report.  Report variables can have their
 own label, or they can USE the contents of other variables.
 To generate new source
 from your report design
 press Ctrl-Enter.
 To exit the Report
 Formatter without
 writing new source,
 press ESC or CTRL-ESC.
 Ctrl-E -- Advancing to a Compiler Error
 In the Clarion Professional Developer environment, the Editor
 and the Compiler work closely together.  The Editor can jump
 to an error detected by the compiler, display the error
 message and provide a help window elaborating on the error.
 Ctrl-W -- Dual Worksheet Editting
 You can view and edit two files at once.  You can copy or
 move blocks of data from one source file to the other, or
 view one file while editting the other.
 This is the Editor's Base window.  Clarion remembers that we were working
 on the source file PHONES.CLA.  We may type a different filename, or we
 can enter a pattern to view a list of available files.
 If we wish to create a
 new file from scratch,
 we would leave this
 field blank.  To edit
 this file, all we have
 to do is press Enter.
 The Editor assumes that we want the Output filename to be
 the same as the input filename.  We could enter a
 different name, which would allow us to create a new file
 starting with an existing file.  For the input and output
 files to be the same, all we have to do is press Enter.
 The Editor stores keyboard macros and Options window settings in
 an edit file (with an extension of .EDT).  The Editor assumes we
 want to use CLA.EDT because the file we are about to edit has an
 extension of .CLA.  We could choose a different edit file at this
 point, but to use this one, all we have to do is press Enter.
 Once the screen source has been compiled, the structure design is
 displayed on the Screen Formatter's worksheet.  This is the menu
 screen from the MENU procedure in our PHONES Designer application.
 From here, we can edit
 the screen display.
 We can type literals,
 paint colors, copy or
 move blocks, resize the
 window, or we can make
 changes to the fields
 and variables that make
 up the screen.
 Use Ctrl-S to display
 the source structure of
 the screen's fields and
 variables.
 The Source window is
 where you change screen
 characteristics, create
 variables, fields, and
 menu items.  You can
 reorder fields and
 variables and create
 REPEAT structures of
 variables or fields.
 'Display Directory' is a
 Menu item.  Menu items
 are strings within MENU
 structures that offer
 choices to a user.
 Menus are one of the
 five types of fields. If
 we press Enter, the Menu
 Item window will appear.
The CLARION Editor
  Exit Without Changes:No
Yes  No
 Type information into each field
 then press the Enter key.
 The directory is updated after
 the last field is entered.
 !Formatting
The CLARION Helper
  Help file :
  Window
  Chained to:
  Position  :FLOAT
FLOAT/FIX
  Attribute :NORMAL
 This is the Helper tutorial.  It should
 be viewed after the Designer tutorial.
 In the Designer tutorial we named a help
 file (PHONES.HLP) containing three help
 windows (MENU, TABLE, and FORM).  Let's
 create those help windows with Helper.
This is Helper's base window.  We want to
create a help file named PHONES.HLP.  The
.HLP extension is a default in Helper.
 Let's create the MENU window first.  MENU
 was the help window we named in Designer
 to be used with the MENU procedure.
 Help windows can be chained together.
 When the operator presses Enter from
 a help window, the "chained to" window
 is displayed.
 We will not chain MENU.
 We will make MENU a floating window.  A
 floating window is positioned so that it
 does not obscure the current field being
 entered.  In our case, the current entry
 field is the menu selector bar.
 We will make MENU blue on green.
  Loading edit file
 "Loading file
 Use the up and down arrow keys
 to move the selector bar.
 Then press the Enter key.
2,767
4,815
Options
  Input File :C:\CLARION\PHONES.CLA
  Output File:C:\CLARION\PHONES.CLA
  Edit File  :C:\CLARION\CEDT.EDT
  Block Mode :LIN
LIN  CHR
  Indention  :On
  Zone Insert:On
  Ruler Lines:Off
  Typing Mode:OVR
INS  OVR  Neutral
  Caps Lock  :On
Off  Neutral
  Scroll Lock:On
Off  Neutral
  Compress
Yes  No
  Change Tabs:No
Yes  No
  Edit Width :80
Size:919
  Memory Use :1k/179k
Date: 3/10/90
  Amount Used:0%
Time:14:40
 The Editor's Options window allows you to: change the
 output filename, switch to another edit file, and select
 the modes and features that are automatically toggled on
 or off each time you begin an editing session.
 To call the Editor's Options window you would have to
 press Ctrl-O.
 The top section
 of the Options
 window displays
 the name of the
 current input
 file.  This can
 not be changed.
 The middle section of
 the Options window is
 where you can indicate
 new output and edit
 filenames and toggle
 various editing features
 on or off.
 The bottom section of the Options window displays the
 following information about the input file: size, the
 memory in use, the percentage of memory currently in
 use, the width of the widest line, and the date and time
 that the file was last written out to disk.
 To change the tab stops stored in the current edit file,
 select Yes at the Change Tabs field.  The options window
 will be replaced by the ruler lines.  Here you can set up
 or change tab-stop settings.
 Directory entries for the current directory are
 displayed in the table below.  We enter a blank
 DOS command to set the directory options.
 The pattern determines which directory entries
 are displayed.  The pattern *.* means all files
 for all extensions.  Let's display only source
 files--files with an extension of .CLA.
 We can display the directory entries as they
 occur in the directory, or we can sort them
 by filename, extension, size, date created,
 or time created.  Let's sort by file size.
 And we can sort the directory into ascending or
 descending sequence.  It's already in ascending
 sequence, so let's sort it descending.
 We don't want to display directory entries that
 are marked "hidden" by DOS.  And we don't want
 a pause after executing a DOS command.  (We
 can always "flashback" with Ctrl-F.)
 Now let's reset the directory options to their
 default values and take a look at the directory
 entry table.
Point to destination, then press Enter to COPY
8PAGE_HEADER
Header
  Phone Directory
  Name
Address
Phone
 PGRP_HEADER
Detail
%DETAIL
Detail
GRP_FOOTER
Detail
%RPT_FOOTER
Detail
JDetail
%PAGE_FOOTER
Footer
 "Page <<#
8PAGE_HEADER 5:1
 &LIN OVR ZON IND CAP
DETAIL
DETAIL
COL(4)
STRING(30),USE(PHN:NAME)
COL(35)
STRING(30),USE(PHN:ADDRESS)
COL(66)
STRING(@P
PB),USE(PHN:PHONE)
ROW(+1,35)
STRING(20),USE(PHN:CITY_STATE)
COL(56)
STRING(@N05B),USE(PHN:ZIP)
 "Variable
  Control Before :
Label:
  Parameter
:@S30
Label:
Use:PHN:ADDRESS
  Control After  :
Label:
  Formfeed Before:No
Yes  No
  Formfeed After :No
Yes  No
  Overprint Next :No
Yes  No
 The Editor's ruler lines are a pair of highlighted bars
 surrounding the cursor line.  The bottom ruler line shows
 tab stops.  Any character typed here will designate a tab
 stop.  When Enter is pressed, tab information is stored in
 the current edit file, along with your keyboard macros and
 other Options window settings.
 When editing source in the Editor's worksheet area, you
 can toggle the ruler lines on or off at any time by
 pressing Ctrl-R.
Phone Directory
Display Directory
Print Directory
SCREEN
SCREEN
WINDOW(12,25),PRE(SCR),HUE(15,1)
ROW(2,21)  ENTRY,USE(?FIRST_FIELD)
ROW(2,21)  MENU,USE(?MENU_FIELD)
ROW(5,5)
STRING('Display Directory')
ROW(7,6)
STRING('Print Directory')
ROW(9,12)
STRING('Quit')
Field Type:String
     String Entry Menu Pause Repeat Point Text
  Display Directory
  Row: 5 Col: 5
Menu Item String
  Parameter  :'Display Directory'
  Label
  Description:
  Help
  Attribute  :Normal
Select  :Reversed
ROW(5,5)
STRING('Display Directory')
Data Window Prompts
Light Cyan on Blue
Press B to toggle Blink
/ /!/"/#/$/%/&/'/(/)/*/+/,/-/.
?0?1?2?3?4?5?6?7?8?9?:?;?<?=?>
O@OAOBOCODOEOFOGOHOIOJOKOLOMON
_P_Q_R_S_T_U_V_W_X_Y_Z_[_\_]_^
o`oaobocodoeofogohoiojokolomon
 How about light magenta on blue ?
Press a key to continue
Mark block to be MOVED, then press Enter
Move cursor to draw track or press Ctrl-T for track options.
  To add a new entry: Press Ins.
  To delete an entry: Press Del.
  To change an entry: Select it and
press Enter.
  To add a new entry: Press Ins.
  To delete an entry: Press Del.
  To change an entry: Select it and
press Enter.
C:\PHONES
(Parent)  9-16-87 10:44a
PHONEBK  DAT
2,767 11-13-87 11:39a
PHONEBK  K01
2,048 11-09-87  4:28p
PHONES
6,626 11-13-87 11:11a
PHONES
292 11-24-87  3:18p
PHONES
998 11-05-87  9:49a
PHONES
1,069 11-13-87 11:11a
PHONES
128,745 11-24-87  1:33p
PHONES
767 11-19-87  8:48a
PHONES
2,580 11-13-87 11:11a
PHONES
1,897 11-13-87 11:11a
PHONES
1,501 11-24-87  3:18p
PHONES
966 11-13-87 11:11a
PHONES
335 11-13-87 11:13a
PHONES
335 11-13-87 11:13a
PHONES
3,711 11-24-87  1:33p
PHONES
253 11-24-87  3:18p
PHONES1  BAK
1,053 11-13-87 11:11a
PHONEB1  CLA
1,068 11-19-87  9:13a
PHONES1  LST
2,276 11-19-87  9:14a
PHONES1  MAP
351 11-19-87  9:14a
PHONES1  OBJ
956 11-24-87  3:18p
PHONES1  PRO
433 11-19-87  9:14a
PHONES2  BAK
3,571 11-13-87 11:34a
PHONES2  CLA
3,571 11-13-87 11:39a
PHONES2  LST
6,663 11-13-87 11:39a
PHONES2  MAP
1,141 11-13-87 11:39a
PHONES2  OBJ
2,838 11-24-87  3:18p
PHONES2  PRO
833 11-13-87 11:39a
PHONES3  CLA
 11-13-87 11:11a
PHONES3  LST
4,316 11-13-87 11:13a
PHONES3  MAP
752 11-13-87 11:13a
PHONEB3  OBJ
1,837 11-24-87  3:18p
PHONES3  PRO
733 11-13-87 11:13a
PHONES4  BAK
917 11-13-87  1:38p
PHONES4  CLA
917 11-13-87  1:38p
PHONES4  LST
2,032 11-13-87  1:38p
PHONES4  MAP
335 11-13-87  3:18p
PHONES4  OBJ
919 11-24-87  1:38p
PHONES4  PRO
373 11-13-87 11:13a
PHONES5  CLA
68 11-13-87 11:13a
PHONES5  LST
369 11-13-87 11:13a
PHONES5  MAP
104 11-13-87 11:13a
PHONES5  OBJ
263 11-24-87  3:18p
PHONES4  CLA
917 11-13-87  1:38p
PHONES4  LST
2,032 11-13-87  1:38p
PHONES4  MAP
335 11-13-87  3:18p
PHONES4  OBJ
919 11-24-87  1:38p
PHONES4  PRO
373 11-13-87 11:13a
PHONES5  CLA
68 11-13-87 11:13a
PHONES5  LST
369 11-13-87 11:13a
PHONES5  MAP
104 11-13-87 11:13a
PHONES5  OBJ
263 11-24-87  3:18p
PHONES5  PRO
78 11-13-87 11:13a
PHONES6  CLA
3,043 11-13-87 11:11a
PHONES6  LST
5,674 11-13-87 11:13a
PHONES6  MAP
859 11-13-87 11:13a
PHONES6  OBJ
686 11-13-87  3:18p
\PHONES
(Sub-dir)  9-16-87 10:44a
\REFMMAN
(Sub-dir)  3-09-87 10:52a
     \ROBOT
(Sub-dir)  8-26-87  8:34a
     \SAVE
     (Sub-dir)  3-20-87  1:42p
     \SAVEREF
(Sub-dir) 11-13-87 11:11a
     \SAVETUT
(Sub-dir) 11-24-87  3:18p
     \SCHEDULE
(Sub-dir)  3-09-87 10:53a
     \TEMP
     (Sub-dir) 11-10-87  2:40p
     \TEST
     (Sub-dir)  4-16-87  2:28p
     \TUTORIAL
(Sub-dir)  9-17-87  7:57a
     \WRT
(Sub-dir)  3-09-87 10:26a
AUTOEXEC BAK
126  9-17-87  1:30p
AUTOEXEC BAT
125 10-02-87  2:42p
COMMAND  COM
22,042  8-14-84  8:00a
PHONES
1,069 11-13-87 11:11a
PHONES1  CLA
1,068 11-19-87  9:13a
PHONES2  CLA
3,571 11-13-87 11:39a
PHONES3  CLA
 11-13-87 11:11p
PHONES4  CLA
917 11-13-87  1:38p
PHONES5  CLA
68 11-13-87 11:11a
PHONES6  CLA
3,043 11-13-87 11:13a
PHONES5  CLA
68 11-13-87 11:11a
PHONES4  CLA
917 11-13-87  1:38p
PHONES1  CLA
1,068 11-19-87  9:13a
PHONES
1,069 11-13-87 11:11a
PHONES3  CLA
 11-13-87 11:11p
PHONES6  CLA
3,043 11-13-87 11:13a
PHONES2  CLA
3,571 11-13-87 11:39a
PHONES2  CLA
3,571 11-13-87 11:39a
PHONES6  CLA
3,043 11-13-87 11:13a
PHONES3  CLA
 11-13-87 11:11p
PHONES
1,069 11-13-87 11:11a
PHONES1  CLA
1,068 11-19-87  9:13a
PHONES4  CLA
917 11-13-87  1:38p
PHONES5  CLA
68 11-13-87 11:11a
 Directory entries for the current directory
 are displayed in the table below.  \PHONES
 is the current directory.  "\.." represents
 the next highest (parent) directory.
 Ctrl-G is used with directory entries.  Ctrl-L
 lists directory and file entries to the printer.
 The remaining control keys are used to process
 selected or marked files.
 We select a file with the selector bar.  We
 can mark the selected file by pressing Ctrl-M.
 Ctrl-U "unmarks" the selected file.  Let's mark
 both extensions for PHONEBK (.DAT and .K01).
 Ctrl-C, Ctrl-D, Ctrl-P, Ctrl-R, and Ctrl-T can
 can be used instead of the COPY, DEL (delete),
 PRINT, RENAME, and TYPE commands to operate on
 the marked entries or the selected entry.
 For example, to save the two marked files in a
 directory called \SAVE, we press Ctrl-C (copy)
 and enter the destination parameter (\SAVE).
 Clarion "remembers" the source, help, and
 data files you are currently working on.
 Ctrl-S selects the file under the selector
 bar as a "current" file.
 Ctrl-X executes the file under the selector
 bar as a DOS command.  The Gray + key moves
 the selected filename and extension up to the
 cursor on the DOS command line.  Gray - moves
 the extension.
 With the cursor on the DOS command field, the
 up and down arrow keys move the selector bar.
 With the selector bar at the bottom of the
 table, down arrow scrolls the table up.
 And we press PgDn to scroll the table to the
 next page of directory entries.
 Ctrl-PgDn scrolls to the end of the directory.
 And Ctrl_PgUp scrolls back to the beginning.
 Entries in the table are either directories or
 files.  Directories start with a backslash (\).
 \.. is the parent directory--the directory that
 contains \PHONES as a sub-directory.
 To change the current directory (which is now
 \PHONES) we select a directory entry and press
 Ctrl-G (Go to).  The only directory in \PHONES
 is the parent (\..).  We will go there.
 The parent directory of \PHONES is the root
 directory (\).  From here we can go to any
 sub-directory.  Let's go back to \PHONES.
The CLARION Tailor
  Environment Colors:No
Default
  Quick Start Colors:No
Default
  Window Shadows
  Set Keyboard Locks:Yes
  Error Beep
  Enhanced Keyboard :Yes
  Video Timeout Mins:10
  Compiler Listings :Yes
Lines on Page
Control Before  :
Control After
  Conditional Stream:No
  Statement Column  :14
Column Indention: 2
Keyword Case
:UPPER
Caps  UPPER  lower
Non-Keyword Case:UPPER
Caps  UPPER  lower  As is
Translate Tracks:No
 This is the Tailor tutorial.
 With Tailor, you can customize the "look and feel" of
 the Clarion Professional Developer's screens, reports,
 and generated source code.
 By printing 58 lines then skipping to
 a new page, we avoid the problem caused
 by printers that automatically skip 6
 lines after printing line 59.
 Control Before and Control After are
 printer control strings that are sent
 to the printer prior to and following
 a listing.
 A stream compile processes all the source
 modules in an application.  A conditional
 stream compile processes only the modules
 that have changed since the last compile.
 The last section controls the generated source code.
 Starting declaration statements in column 14 leaves
 room for a 12-character label.
 A 2-column indention prevents a program from creeping
 off the screen on the right.
 Generated keywords can be upper case, lower case, or
 capitalized.  Non-keywords are usually labels that
 you enter.  They can be left alone (As is) or changed
 to upper case, lower case, or capitalized.
 Tracks are the single and double line graphics used
 for line drawing.  If your printer cannot print these
 characters, answer "Yes" and they will be translated
 to their ASCII codes.
 This completes the Tailor tutorial
 Let's return to the tutorial menu.
 You can change the colors that Quick-Start
 will use  in the same  way that we changed
 the Environment colors.
 This is Tailor's base window.
 The top section of Tailor controls the look and feel
 of screen entry.
 Screen Colors can be left alone or painted to fit your
 mood.  And if you ever want to start over, the screens
 can be reset to their original colors.
 Let's change some screen colors.  We select "Yes".
 So here is Tailor with light magenta
 prompt words.  It doesn't look that
 great.
 Let's reset to the default colors.
 Window shadows are an artistic touch,
 but they can obscure data.  If you
 don't want shadows, answer "No".
 Clarion programs optionally manipulate
 the Caps, Num, and Scroll Lock keys.
 On multi-user systems this feature must
 be suppressed (answer "No").
 If beeping annoys you, answer "No" to
 Error Beep.
 The enhanced keyboard contains two extra
 function keys (F11 & F12) that cannot be
 be read by the standard keyboard routine.
 Answer "Yes" if your programs use F11 or
 F12 and will NEVER encounter a standard
 keyboard.
 The video monitor will be blanked after
 10 minutes of disuse.  Pressing any key
 restores the screen.  Enter the timeout
 period in minutes or enter zero for no
 video timeout.
 The next Tailor section concerns the
 Compiler and its associated listings.
 The Compiler optionally generates a
 listing file.  If you know you won't
 need the listing and want to compile
 faster, answer "No".
Track Type
Single
  Double
  Block
 Mixed
 Mixed
! " # $ % & ' ( ) * + , - . / 0 1 2 3 4 5 6 7 8 9 : ; < = > ?
  @ A B C D E F G H I J K L M N O P Q R S T U V W X Y Z [ \ ] ^ _
  ` a b c d e f g h i j k l m n o p q r s t u v w x y z { | } ~
 This is the Editor tutorial.  The Clarion Editor is a full-
 screen line editor with numerous features designed to help
 you create and revise your Clarion source files.  The
 Editor also includes a built-in source compiler, interactive
 designer, and source code generator for both screens and
 reports.
 Clarion source files are DOS ASCII text files.  Each line
 is terminated by a carriage return/line feed sequence.
 When written to disk, source files are stored with tabs
 compressed with tab stops at 1, 9, 17, etc.  Source lines
 may contain up to 255 characters.
 !Updating source
Keyin Attribute
Yellow on Green
Normal
Reversed
Enhanced
Rev+Enh
Blink
Rev+Blk
Blk+Enh
 Rev+Blk+Enh
Press B to toggle Blink
/ /!/"/#/$/%/&/'/(/)/*/+/,/-
?0?1?2?3?4?5?6?7?8?9?:?;?<?=?>
O@OAOBOCODOEOFOGOHOIOJOKOLOMON
_P_Q_R_S_T_U_V_W_X_Y_Z_[_\_]_^
o`oaobocodoeofogohoiojokolomon
Screen Attribute
Blue on Green
Transparent
Press B to toggle Blink
Press T to toggle Transparent
"/#/$/%/&/'/(/)/*/+/,/-/.
?0?1?2?3?4?5?6?7?8?9?:?;?<?=?>
O@OAOBOCODOEOFOGOHOIOJOKOLOMON
_P_Q_R_S_T_U_V_W_X_Y_Z_[_\_]_^
o`oaobocodoeofogohoiojokolomon
Track Attribute
Bright White on Green
Normal
Reversed
Enhanced
Rev+Enh
Blink
Rev+Blk
Blk+Enh
 Rev+Blk+Enh
Press B to toggle Blink
/ /!/"/#/$/%/&/'/(/)/*/+/,/-/.
?0?1?2?3?4?5?6?7?8?9?:?;?<?=?>
O@OAOBOCODOEOFOGOHOIOJOKOLOMON
_P_Q_R_S_T_U_V_W_X_Y_Z_[_\_]_^
o`oaobocodoeofogohoiojokolomon
  Writing the file
Then press the Enter key.
to move the selector bar.
to move the selector bar.
Use the up and down arrow keys to move the selector bar.
Then press the Enter key.
 This is Helper's worksheet.
 We begin by typing free-form help information
 anywhere on the worksheet.  We want to explain
 how to make a menu selection.
 We press the Enter key to take us out
 of tracking mode and we reduce the size
 of the window with Ctrl-W.
 OK, this will be our help window for the
 MENU screen of the PHONES application.
 Similarly, we have painted a help window
 for the TABLE procedure.
 This looks pretty good, but let's highlight
 a few of the key words in yellow.
 We can "paint" the words (Ctrl-P) or we can
 change their video attribute (Ctrl-A).
 Paint "sticks" to the background and does
 not move with the words.  Attributes stay
 with the words as you move them.
 Let's change the attributes.  First we set
 the video attribute color with Ctrl-V.
 Then we type Ctrl-A over each character
 position we want changed.
 This is the help window we will be using with
 our TABLE procedure.
 Finally,  we create a final help window to be
 used with our FORM procedure.
 This completes the Helper tutorial.
 The Compiler tutorial should be viewed next.
 That's about all we need to say.
 To make it more rectangular let's
 move the bottom line down so we
 can break the top line up.
 To move a block of text, point the cursor to it
 and press Ctrl-M (move).  Then move the cursor
 through it and press Enter to "grab" it.  Now
 you can move it anywhere with the cursor keys.
 Press Enter when it is in the right place.
 Using the move command again,
 let's break up the top line.
 Now let's draw a box around our help screen.
 We put the cursor in position to draw the
 box and then we press Ctrl-T (track).
 The default is a double track.
 We can choose this by pressing
 Enter.
 Now we use Ctrl-V to choose
 a Track Attribute.  Let's use
 Bright White on Green.
 Now we can draw the box by moving the cursor.  The
 track "follows" us like an "Etch-a-Sketch".
 If we make a mistake, the backspace key "untracks".
BAR
CLR     "
CLR_W1
CLR_W2
CLR_W3
CPY     ^
CTRL-C
CTRL-F
CTRL-G
CTRL-J
CTRL-K  C
CTRL-S
CTRL-T
CTRL-X  W
DIR
DIR_W1
DIR_W2
DIR_W3
DIR_W4  e
DIR_W5
DSK1
DSK2
DSK3
EDT
EDT1
EDT1_15A
EDT1_15B
EDT1_20Ap'
EDT1_20B|(
EDT1_W1
EDT1_W10
EDT1_W11
EDT1_W12
EDT1_W13..
EDT1_W14
EDT1_W16
EDT1_W17'0
EDT1_W18
EDT1_W19
EDT1_W2 #3
EDT1_W21
EDT1_W22
EDT1_W23
EDT1_W24
EDT1_W25;>
EDT1_W26
EDT1_W3
EDT1_W4 zB
EDT1_W5 RC
EDT1_W6 DD
EDT1_W7A,E
EDT1_W7B
EDT1_W8A=F
EDT1_W8B
EDT1_W9
EDT2
EDT2_W1
EDT2_W10
EDT2_W11
EDT2_W12
EDT2_W13"N
EDT2_W14)O
EDT2_W15eP
EDT2_W16zR
EDT2_W17SS
EDT2_W2
EDT2_W3A
EDT2_W3B
EDT2_W4
EDT2_W5 yV
EDT2_W6
EDT2_W7
EDT2_W8 _Y
EDT2_W9 ?Z
EDT3
EDT4
EDT5
EDT5_W1
EDT5_W2
EDT6
EDT6_W1 Zg
EDT6_W10Ji
EDT6_W2 (j
EDT6_W3 uk
EDT6_W4
EDT6_W5
EDT6_W6
EDT6_W7 kp
EDT6_W8     t
EDT6_W9 }u
EDT7
EDT8
EDT8_W1 G|
EDT8_W2
EDT8_W3 a
EDT8_W4
EDT8_W5
EDT8_W6
EDT8_W7
EDT8_W8 T
EDT8_W9 L
EDT_W10 *
EDT_W11
EDT_W12 :
EDT_W13 t
EDT_W1A
EDT_W1B
EDT_W2
EDT_W3
EDT_W4  s
EDT_W5  n
EDT_W6
EDT_W7
EDT_W8  _
EDT_W9
EXIT
FORM
FORMAT
HLP
HLP_W1  2
HLP_W2  h
HLP_W3
HLP_W4
HLP_W5
HLP_W6
LOADEDIT
LOADFILE
MENU    Q
MRK1
MRK2    3
MRK3    c
OPTIONS
OPTS_W1
OPTS_W2 W
OPTS_W3
OPTS_W4
OPTS_W5
OPT_W1
OPT_W2
OPT_W3
OPT_W4
OPT_W5  [
OPT_W6  E
POINT
RPT1    -
RPT2    I
RPT3    ;
RULER   ,
RULR_W1
RULR_W2 2
SCR1
SCR2    H
SCR3
SEL
SEL_W1
SKEY    _
SMOV
STRK
TABLE   7
TABLE1  m
TBL1    [
TBL2
TBL3    4
TBL4
TBL5
TBL6
TBL7
TBL8
TBL9
TBL_W1  H
TBL_W10 (
TBL_W11
TBL_W12
TBL_W13
TBL_W14
TBL_W15 v
TBL_W2  w
TBL_W3
TBL_W4  z
TBL_W5
TBL_W6  G
TBL_W7
TBL_W8
TBL_W9  x
TLR     (
TLR_W1
TLR_W10
TLR_W11 T
TLR_W12
TLR_W13
TLR_W14
TLR_W15
TLR_W16
TLR_W17 d
TLR_W2
TLR_W3  D
TLR_W4
TLR_W5  W
TLR_W6
TLR_W7
TLR_W8
TLR_W9
TOPT
TTL1
TTL2
UPDATING=
VATT    k
VBOX    [
VSCR
VTRK    U
WHITE   W
WRITING
WRK
WRK1
WRK2    F
WRK3
WRK_SAV
WRK_W1  8
WRK_W10
WRK_W11
WRK_W12 w
WRK_W13 V
WRK_W14 `
WRK_W15
WRK_W16
WRK_W2
WRK_W3
WRK_W4
WRK_W5  W
WRK_W6
WRK_W7
WRK_W9